home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 17 / QRZ Ham Radio Callsign Database - Volume 17.iso / utils / qpv / cfg / cfg.doc < prev    next >
Text File  |  1995-04-03  |  5KB  |  93 lines
  1.  
  2.     QPV/386 configuration files
  3.    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  4.  
  5. This textfile is intended to be read by people who want to create their
  6. own configuration file or modify existing configuration files.
  7. You normally needn't do that, just pick the configuration file for your
  8. graphics card.  For more information please read the file INSTALL.DOC
  9. (directory ENGLISH).
  10.  
  11. Before making any changes to QPV.CFG files, please read these
  12. instructions carefully.
  13.  
  14. The QPV.CFG files define all available video modes that are used by
  15. QPV/386.  You may edit it with a standard ASCII text editor (for example EDIT
  16. which is distributed along with MS-DOS 5/6).  If you want to make changes,
  17. you should have some fundamental knowledge about your video modes.  Most
  18. VGAs come with a manual which contains at least a list of available
  19. modes and their corresponding mode numbers.  If you can't get certain
  20. modes to work, send me a letter or electronic mail, and I'll try to help
  21. you (of course I'll try harder if you're a registered user :-).
  22. However, there's no guarantee or obligation of any kind for me.
  23.  
  24. Comments in QPV.CFG are preceded by either '#', ';', or '%'.
  25. Empty lines are ignored.
  26.  
  27. The first line (not counting comments, of course) defines the type of your
  28. video card.  This is the format of the first line:
  29.    type order
  30. 'type' and 'order' must be seperated by at least one space.
  31.  
  32. 'type' denotes which of the driver files will be used.  For example,
  33. if you specify 'ET4000', there must be a file ET4000.DRV.
  34. 'order' must be either 'RGB' or 'BGR'.  It specifies the byte order in
  35. true color modes (24 bit).  If you're not sure about the order, try both,
  36. either 'RGB' or 'BGR' will give you the correct colors (if, for example,
  37. skin looks blue, try the other option).
  38. If you don't have a true color card (i.e. no 24 bit modes), the value of
  39. 'order' doesn't matter (though it must be specified).
  40.  
  41. All subsequent lines define the video modes available with your card.
  42. This is the format of each line:
  43.    width height colors line ax bx options
  44. All items must be seperated by at least one space.
  45.  
  46. 'colors' must be one of the following:
  47.  -  '16': 16 colors (4 bit), greyscale display only
  48.  - '256': 256 colors (8 bit), greyscale and dithered color display
  49.  - '32K': 32 K colors (hicolor, 15 bit), color display
  50.  - '64K': 64 K colors (hicolor, 16 bit), color display
  51.  - '16M': 16 M colors (truecolor, 24 bit), color display
  52. 'line' specifies the amount of memory used for a single row of pixels.
  53. This is usually the width multiplied by the number of bytes used to store
  54. a single pixel.
  55. 'ax' and 'bx' specify the register values for interrupt 10h.
  56. For standard modes, ax is the mode number, and bx is 0.
  57. 'options' (optional) is zero, one, or more of the following characters
  58. (not seperated by spaces!):
  59.  - 'C': clear video memory (some SVGAs don't clear the screen at a mode
  60.         set, in this case use this option for the relevant mode).
  61.  - 'R': Reinitialize video mode instead of clearing the video memory
  62.         (this shouldn't be necessary for most cards).
  63.  - 'D': debug mode (for testing purposes only, not intended to be used
  64.         by the end user).
  65.  - 'M': this option might be necessary for the true color mode of the
  66.         MegaEva 1024-S.
  67.  - 'H': only necessary for 64K hicolor modes on ET4000 based cards,
  68.         it switches the ET4000 BIOS from 32K to 64K mode.
  69.  - '3': 3 bytes per pixel in truecolor mode.
  70.  - '4': 4 bytes per pixel in truecolor mode.  If neither '3' nor '4' is
  71.         specified, QPV/386 will try to autodetect the number of bytes per
  72.         pixel (which is usually correct).
  73.  
  74. Values for 'width', 'height', 'line', 'ax', and 'bx' are in decimal.
  75. You can use hexadecimal notation by preceding the values with a dollar
  76. sign '$', for example '$10f0'.
  77.  
  78. IMPORTANT:  Using modes that your hardware (graphics card and/or monitor)
  79. can't handle can damage your hardware!  Be sure to use only supported
  80. modes.  If you come across a mode which looks flickering or unstable
  81. (i.e. the monitor can't hold the picture), abort QPV/386 immediately and
  82. delete that mode from the configuration file.
  83.  
  84. YOU ARE USING QPV/386 AT YOUR OWN RISK!  THE AUTHOR (OLIVER FROMME) IS NOT
  85. RESPONSIBLE FOR ANY DAMAGE CAUSED BY THE USE OF QPV/386 OR BY THE INABILITY
  86. TO USE QPV/386.  IF YOU ARE NOT SURE ABOUT THIS, OR IF YOU DON'T ACCEPT THIS,
  87. THEN DO NOT USE QPV/386!
  88.  
  89. QPV/386 is inexpensive shareware.  If you continue using it after a trial
  90. period of 30 days, you are encouraged to pay a small registration fee.
  91. The source code of the JPEG decoding routines is also available.
  92. For more details please read the documentation of QPV/386.
  93.